<?php
namespace app\admin\controller;


/**
 * @title 广告管理
 * @description 接口说明
 * @group admin
 * @header name:authorization require:1 default: desc:登陆的token
 */
class Advert extends Base
{
    protected $_order = 'id desc';

    /**
     * @title 广告获取(get)
     * @description 接口说明     
     * @author hardy
     * @url /admin/advert
     * @method GET
     *
     * @param name:id type:int require:0 default:1 other: desc:唯一ID，获取某条记录详情，则为必填，id和page选填其一
     * @param name:page type:int require:0 default:1 other: desc:页码数 获取第二页以上的数据必填，默认值为1，id和page选填其一
     * @param name:size type:int require:0 default:20 other: desc:每一页的数量，默认20
     * @param name:place type:int require: default: other: desc:分页搜索可选条件，广告的位置，1pc端，2移动端
     * @param name:title type:string require: default: other: desc:分页搜索可选条件，广告名称
     * @param name:publish type:int require: default: other: desc:分页搜索可选条件，发布状态：0待发布，1已发布，2已下架
     *
     * @return title:广告标题
     * @return link:跳转链接
     * @return photo_link:广告图片
     * @return page_view:浏览量
     * @return init_view:初始浏览量
     * @return capacity:加载量
     * @return max_capacity:最大加载量
     * @return place:广告位置，1 pc端，2 移动端
     * @return publish:0待发布，1已发布，2已下架
     * @return create_time:创建时间
     * @return user_desc:创建者
     *
     * @return list:消息列表,有page参数则返回值list，list是一个数组，
     * @return size:每页最大数，默认20，可由前端传递参数决定 page参数返回值，
     * @return page:当前页，page参数返回值，
     * @return count:总记录数， page参数返回值，
     */
    public function gets()
    {
        parent::gets();
    }
    protected function _searchPage(&$where)
    {
        $data = input('get.');
        $key = 'title';
        if(!empty($data[$key])){
            $where[] = [$key,'like', "%{$data[$key]}%"];
        }
        $key = 'place';
        if(!empty($data[$key])){
            $where[] = [$key,'=', $data[$key]];
        }
        $key = 'publish';
        if(isset($data[$key]) && $data[$key] !== ''){
            $where[] = [$key,'=', $data[$key]];
        }
    }
    /**
     * @title 创建广告 (post)
     * @description 用户登录
     * @author hardy
     * @url /admin/Advert
     * @method POST
     *
     *
     * @param name:title type:string require:1 default: other: desc:广告名称
     * @param name:link type:string require:1 default: other: desc:跳转地址
     * @param name:photo_link type:string require:1 default: other: desc:广告图片
     * @param name:init_view type:string require:0 default:0 other: desc:初始浏览量
     * @param name:max_capacity type:string require:0 default:0 other: desc:最大加载量
     * @param name:place type:string require:1 default:0 other: desc:广告位置
     * @param name:publish type:string require:0 default:0 other: desc:广告位置
     *
     * @return title:广告标题
     * @return link:跳转链接
     * @return type: 广告位置，1 pc端，2 移动端
     * @return photo_link:广告图片
     * @return page_view:浏览量
     * @return init_view:初始浏览量
     * @return capacity:加载量
     * @return max_capacity:最大加载量
     * @return place:1首页，2底部
     * @return publish:0待发布，1已发布，2已下架
     * @return user_desc:创建者
     */
    public function create(){
        parent::create();
    }
    /**
     * @title 修改广告（put）
     * @description 修改密码
     * @author hardy
     * @url /admin/Advert
     * @method put
     *
     *
     * @param name:title type:string require:1 default: other: desc:广告名称
     * @param name:link type:string require:1 default: other: desc:跳转地址
     * @param name:photo_link type:string require:1 default: other: desc:广告图片
     * @param name:init_view type:string require:0 default:0 other: desc:初始浏览量
     * @param name:max_capacity type:string require:0 default:0 other: desc:最大加载量
     * @param name:place type:string require:1 default:0 other: desc:广告位置
     * @param name:publish type:string require:0 default:0 other: desc:广告位置
     *
     * @return title:广告标题
     * @return link:跳转链接
     * @return photo_link:广告图片
     * @return page_view:浏览量
     * @return init_view:初始浏览量
     * @return capacity:加载量
     * @return max_capacity:最大加载量
     * @return place:广告位置，1 pc端，2 移动端
     * @return publish:0待发布，1已发布，2已下架
     * @return user_desc:创建者
     */
    public function update(){
        parent::update();
    }
    /**
     * @title 删除广告（delete）
     * @description 修改密码
     * @author hardy
     * @url /admin/Advert
     * @method delete
     *
     * @param name:id type:int|string|array require:1 default: other: desc:单个删除：数字，多组删除：","隔开的数字或者数组
     */
    public function delete(){
        parent::delete();
    }
}